======================================
OpenOCD - Open On-Chip Debugger (JTAG)
======================================

Sources
-------

Project Home Page:  http://openocd.berlios.de/web/

    http://sourceforge.net/projects/openocd/
    
    http://sourceforge.net/projects/openocd/files/openocd/0.4.0/openocd-0.4.0.tar.bz2/download
    
Dependencies
------------

::

    libusb
    libusb-compat
    libftdi


Olimex ARM-USB-OCD
------------------
Serial USB JTAG dongle. 

http://www.olimex.com/dev/arm-usb-ocd.html


OpenOCD settings for the Olimex ARM-USB-OCD
-------------------------------------------

::

    interface ft2232
    ft2232_device_desc "Olimex OpenOCD JTAG"
    ft2232_layout olimex-jtag
    ft2232_vid_pid 0x15ba 0x0003


Configuration using LIBFTDI
---------------------------
The libftdi source code can be download from the following website::

    http://www.intra2net.com/en/developer/libftdi/download.php
    
::

    cd $tools/Sources
    curl -O http://www.intra2net.com/en/developer/libftdi/download/libftdi-0.18.tar.gz
    curl -O http://www.intra2net.com/en/developer/libftdi/download/ftdi_eeprom-0.3.tar.gz
    curl -O http://www.intra2net.com/en/developer/libftdi/download/uisp-cvs20030220-libftdi.patch
    tar -xzf libftdi-0.18.tar.gz 
    tar -xzf ftdi_eeprom-0.3.tar.gz 

Both libusb and libftdi must be built and installed.

To use the newer FT2232H chips, supporting RTCK and USB high
speed (480 Mbps), you need libftdi version 0.16 or newer.  Many Linux
distributions provide suitable packages for these libraries.

Configure the libftdi solution like this::

    cd $tools/openocd-0.4.0
    mkdir build
    cd build
    ../configure --prefix=$prefix --enable-ft2232_libftdi --disable-werror
    make
    make install

Configuration using FTDI D2XX driver
------------------------------------

Download D2XX from FTDI.

Unpack files to a folder in your Sources directory::

    mount 
    mkdir $tools/Sources/FTDI_D2XX
    cd /Volumes/PPC\ D2XX/D2XX/
    cp fljsdf $tools/Sources/FTDI_D2XX
    
Move d2xx files into place::

    cd $tools/Sources/FTDI_D2XX
    
    cp D2XX/bin/ftd2xx.h /usr/local/include/
    cp D2XX/bin/WinTypes.h /usr/local/include/    
    cp D2XX/bin/10.5\ -\ 10.6/libftd2xx.0.1.0.dylib /usr/local/lib/
    
    ln -sf /usr/local/lib/libftd2xx.0.1.0.dylib /usr/local/lib/libftd2xx.dylib
    

Configure::
    
    cd $tools/openocd-0.4.0
    mkdir build
    cd build
    ../bootstrap
    ../configure --prefix=$prefix --enable-ft2232_ftd2xx --disable-werror
    make
    make install
    

Linux
-----

Add path to the configure command::

    --with-ftd2xx-linux-tardir=$tools/Sources/FTDI_D2XX